home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 September / macformat-004.iso / Shareware City / Developers / xtradbfordirector / Xtra Demo Version / Xtra- Read all about it < prev   
Encoding:
Text File  |  1994-07-11  |  4.7 KB  |  118 lines  |  [TEXT/ttxt]
  1. Xtra Data Base-
  2. eXternal Text Rerieval Archives
  3.  
  4. Version 1.3        April '94
  5. Q u i c k    r e f e r e n c e
  6.  
  7. What is Xtra Data Base ?
  8. ======================
  9.  
  10. Xtra is an external data base for developers on MacroMind Director 
  11. applications, HyperCard and other third party developing tools.
  12. Xtra deals with text retrieval and though it is very simple to operate, it is 
  13. very fast and powerful.
  14.  
  15.  
  16. How Does it work ?
  17. =================
  18.  
  19. There are three stages working with Xtra data base:
  20. stage 1-
  21. -------- 
  22. Inserting all data in a very simple syntax into a text file. It can be done by 
  23. any word processor or other application.
  24. The data base contains Records (there is no limit to the number of records 
  25. except your HD capacity). Each record has a name and categories by which 
  26. you will retrieve the record later on (e.g.  serial code, color, address etc.) 
  27. The name of the record is called 'class 0', and each category will be placed 
  28. in a 'key' class. In this version you can fill up to 15 'key' classes for each 
  29. record.
  30. At the end of each record you can add any number of text lines that 
  31. contains additional information, but are not used for search&find.
  32.  
  33. Example:
  34.  
  35. Table                               - class <0> The record's name
  36. Brown                              - class <1> The color of the object
  37. Mahogany wood                 - class <2> The material of the object
  38. 1.80*70*90.5 cm               - class <3> The size of the object
  39. $45                                  - class <4> The price of the object
  40. Description: This table is an antique, 17 century. It belonged to 
  41. the king of England during 1880 - 1930 and then sold to the Berk 
  42. family in New-York.
  43. Note: Do not use Moishe's Movers to transfer the table.
  44.  
  45.  
  46. Stage 2-
  47. --------
  48.  
  49. Using the Xtra application you compile the text file into an Xtra Data 
  50. file. The compiling process is pretty fast (E.g. 50 seconds for compiling 
  51. 2500 records with 5 key classes and 2 text lines).
  52. Now you can operate your data file from the application for an easy 
  53. Debugging. All you have to do is to type the search and retrieve commands, 
  54. and pressing the <enter> key. A 'Ping' sound will occur when search is done. 
  55. Afterwards the result will be typed on the screen.                        
  56. The search and retrieval of information is very fast.                        
  57.                         
  58. Stage 3-                        
  59. --------                         
  60. Working with the data base from inside a developer tool such as MacroMind 
  61. Director. The Xtra commands are  the same as in the stage 2. The director  
  62. uses the Xtra Library file, which is usually placed in the same folder with 
  63. your Application.
  64. At the beginning you type in your script: 'open Xlib [name of Xtra Library 
  65. file]' and afterwards 'OpenXtraFile [name of Xtra Library file],[name 
  66. of data file]' (this opens the data file).                        
  67.                         
  68. You get the information by typing 'SendXtra [Xtra Command]' in 
  69. scripts.                        
  70. The arguments are send to the data file and the information is returned 
  71. into 'the result' variable.                         
  72. You can operate all the arguments that Xtra application supports, and the 
  73. syntax is the same.                        
  74. At the end you should close the data file by typing 'CloseXtraFile' 
  75. followed with 'closeXlib'.                        
  76.                         
  77.                         
  78.                         
  79. Commands list:                        
  80. ~~~~~~~~~~~~                        
  81. To make a long story short, I'll describe to you the main 
  82. commands/arguments:                            
  83. you can retrieve a record's body by it's name.                        
  84. You can search&find record that it's name or classes are equal a string, or 
  85. equal a string with Wildcards (1 char or more), starts with a string, 
  86. from a string, until a string, contains a string, not a string, Between 
  87. two strings and so on.                         
  88. The argument can be simple or parenthesized to identify the group and 
  89. order in which the arguments are calculated. It also obtains a fast logical 
  90. and/or with the defined arguments.                        
  91. The result can be sorted alphabetically, or unsorted. It can be limited 
  92. to only the first (variable) number of records. It can even be defined to 
  93. give as the result another class instead of the name of the records 
  94. (class <0>).                        
  95.                         
  96.                         
  97. Summery:                        
  98. ~~~~~~~                        
  99. A great deal of work was invested in this product (especially by the other 
  100. partners...), so it costs....                        
  101. At this moment we are looking for an international/US dealer and we 
  102. thought of interesting MacroMedia with it as well.                        
  103. We will be very happy to receive any comments and suggestions.
  104.  
  105. A demo version of the Xtra Library Player is enclosed by. It is fully 
  106. operational, except it retrieves up to 10 records only. You may duplicate and distribute the demo version as many copies as you like. Run the 'Xtra 
  107. Example Movie'
  108.  
  109. For more information contact:
  110. Amit Galili & Tsach Solan
  111. Knowledge Systems inc.
  112. Phone: 972-3-6050554, 972-3-7520613
  113. Fax: 972-3-9330968, 972-3-6050554
  114. POB 45075 Tel-Aviv 61540
  115. e-mail: amit1@ccsg.tau.ac.il
  116.             solan1@ccsg.tau.ac.il
  117.  
  118.